home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat3 / PMAPI / _pmparsectime.z / _pmparsectime
Text File  |  1997-04-03  |  3KB  |  67 lines
  1.  
  2.  
  3.  
  4. ____PPPPMMMMPPPPAAAARRRRSSSSEEEECCCCTTTTIIIIMMMMEEEE((((3333))))                                              ____PPPPMMMMPPPPAAAARRRRSSSSEEEECCCCTTTTIIIIMMMMEEEE((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ____ppppmmmmPPPPaaaarrrrsssseeeeCCCCttttiiiimmmmeeee - convert ccccttttiiiimmmmeeee(3) string to ttttmmmm structure
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ppppccccpppp////iiiimmmmppppllll....hhhh>>>>
  13.  
  14.      iiiinnnntttt ____ppppmmmmPPPPaaaarrrrsssseeeeCCCCttttiiiimmmmeeee((((cccchhhhaaaarrrr ****ssssttttrrrriiiinnnngggg,,,, ssssttttrrrruuuucccctttt ttttmmmm ****rrrrsssslllltttt,,,, cccchhhhaaaarrrr ********eeeerrrrrrrrmmmmssssgggg))))
  15.  
  16.      cccccccc ............ ----llllppppccccpppp
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      ____ppppmmmmPPPPaaaarrrrsssseeeeCCCCttttiiiimmmmeeee reverses the aaaassssccccttttiiiimmmmeeee(3C) function.  It accepts a ssssttttrrrriiiinnnngggg
  20.      specifying a time, and fills in the given ttttmmmm structure.
  21.  
  22.      Either a fully specified aaaassssccccttttiiiimmmmeeee(3C) string like "Mon Mar  4 13:07:47
  23.      1996" or a partially specified time like '1996", "Mar 1996", "Mar 4
  24.      1996", "Mar", "13:07:47", "13:07", "Mar 4 13:07:47",... is accepted.  In
  25.      addition, the seconds component may be a floating point number, for
  26.      example "13:07:47.5".  The 12 hour clock is also supported, so "13:07"
  27.      and "1:07 pm" are equivalent.
  28.  
  29.      ____ppppmmmmPPPPaaaarrrrsssseeeeCCCCttttiiiimmmmeeee returns 0 if successful.  It returns -1 and a dynamically
  30.      allocated error message string in eeeerrrrrrrrmmmmssssgggg, if the given ssssttttrrrriiiinnnngggg does not
  31.      parse.  Be sure to ffffrrrreeeeeeee(3C) the error message string.
  32.  
  33.      The ttttmmmm structure returned in rrrrsssslllltttt should only be used as an argument to
  34.      the ____ppppmmmmCCCCoooonnnnvvvveeeerrrrttttTTTTiiiimmmmeeee function, as it contains encoded information that will
  35.      only be correctly interpreted by ____ppppmmmmCCCCoooonnnnvvvveeeerrrrttttTTTTiiiimmmmeeee.
  36.  
  37. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  38.      PPPPMMMMAAAAPPPPIIII(3), ____ppppmmmmPPPPaaaarrrrsssseeeeIIIInnnntttteeeerrrrvvvvaaaallll(3), ____ppppmmmmPPPPaaaarrrrsssseeeeTTTTiiiimmmmeeee(3) and ____ppppmmmmCCCCoooonnnnvvvveeeerrrrttttTTTTiiiimmmmeeee(3).
  39.  
  40. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                                                                         PPPPaaaaggggeeee 1111
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.